home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / game / shoot / WarpQuake_src.lha / WarpQuakeSrc / WarpQuake_src.readme < prev    next >
Text File  |  2000-03-02  |  7KB  |  217 lines
  1. Short: WarpOS Quake port source
  2. Type: game/shoot
  3. Author: Jarmo Laakkonen (jami.laakkonen@kolumbus.fi)
  4. Uploader: Jarmo Laakkonen (jami.laakkonen@kolumbus.fi)
  5.  
  6. WarpQuake 0.6    02-03-2000
  7.  
  8. WarpQuake is a port of Quake based on Awinquake by Peter McGavin.
  9.  
  10. Requirements:
  11.  
  12. PPC board with WarpOS installed.
  13. AGA or GFX board.
  14. TCP/IP stack for network games.
  15. lowlevel.library for joypad support.
  16. Optionally chunkyppc.library.
  17.  
  18. chunkyppc.library is not required, but should speed up things on GFX cards.
  19. Unfortunately I haven't been able to test WarpQuake on a GFX card system,
  20. as I only have AGA, but it should work. In case you have problems with the
  21. chunkyppc support, you can use the -wpa8 switch, but then the game might
  22. run a bit slower.
  23.  
  24. The networking code has only been tested by running two Quake executables
  25. on the same machine. This worked fine.
  26.  
  27. Amiga specific commandline options:
  28.  
  29. -width:
  30. -height:
  31. Use these to specify display width and height when using chunkyppc.library.
  32. Otherwise you only get 320x200 play area although the screen is bigger.
  33. Note that these aren't needed when using native or chunkyppc.library AGA
  34. support.
  35.  
  36. -bat:
  37. Change to BAT MMU setup. This should give a slight speed increase, but
  38. may cause problems on some setups.
  39. This does the same thing as the changemmu tool supplied with WarpOS.
  40.  
  41. -aga:
  42. Use native AGA support with triplebuffering instead of chunkyppc.library.
  43. This is faster than chunkyppc AGA support.
  44.  
  45. -nodb:
  46. Disables AGA multibuffering. Saves one contextswitch but causes slight
  47. flicker.
  48.  
  49. -wpa8:
  50. Use WritePixelArray8(). Use this if chunkyppc support doesn't work.
  51.  
  52. -force:
  53. chunkyppc.library saves the last used screenmode in ENV: and ENVARC:.
  54. Next time you start WarpQuake the screenmode will be read from there.
  55. Use this switch if you want to override this.
  56.  
  57. -mouse:
  58. Enables mouse.
  59.  
  60. -mem:
  61. Sets the heapsize. Default is 8MB, but some Total Conversions may
  62. require more than this. BTW If you are looking for a good TC, try
  63. After the fall. You'll never want to play basic Quake again.
  64.  
  65. -joypad:
  66. Enables CD32 joypad. You need to bind the buttons yourself.
  67. The buttons are located in AUX1 - AUX11.
  68. AUX1  = left
  69. AUX2  = right
  70. AUX3  = up
  71. AUX4  = down
  72. AUX5  = red
  73. AUX6  = green
  74. AUX7  = yellow
  75. AUX8  = blue
  76. AUX9  = play
  77. AUX10 = forward
  78. AUX11 = reverse
  79.  
  80. Binding example: In Quake console type, BIND AUX5 "+ATTACK"
  81.  
  82. Additinally chunkyppc.library supports the following enviroment variables:
  83.  
  84. WarpQuake/dbuf:
  85. Use Doublebuffering.
  86.  
  87. WarpQuake/oldstyle:
  88. If this is set, ScrollVPort will be used, else Triple Buffering using
  89. ScreenBuffers.
  90.  
  91. WarpQuake/wb:
  92. If this is set, a Workbench Window will be used, not a screen
  93.  
  94. WarpQuake/pip:
  95. If this is set, a Picture in Picture will be used using the Picasso96API.library.
  96. Note: Not all Graphics Boards Support this. Currently only P96 PIP is supported,
  97. not CGX. Maybe in the future...
  98.  
  99. WarpQuake/pipnoclear:
  100. If this is set to 1, the PIP won't be cleared when opened.
  101.  
  102. WarpQuake/rtgmaster:
  103. Use rtgmaster Screenmode Requester instead of ASL one. rtgmaster.library
  104. will only be opened when this option is set, so that rtgmaster.library
  105. does not need to be installed to be able to use chunkyppc.library.
  106.  
  107. WarpQuake/likecgx:
  108. If you want CGX-like WB Window Support for P96 (Faster, but Window Borders
  109. disappear). For CGX it is automatically set, as it is the only possible
  110. method for CGX to reach (at least for 16 Bit) WB Window Support, for P96
  111. it is optional.
  112.  
  113. lockingmode:
  114. Set this to 0 for best performance on GFX cards.
  115.  
  116.  
  117. History:
  118.  
  119. 0.6:
  120. I released 0.5 too fast. The game would hang on exit if not using
  121. joypad.
  122.  
  123. 0.5:
  124. Removed a small bug in the joypad code.
  125. It should be possible to use screens bigger than 320x200 with
  126. chunkyppc.library now, but you have to use the -width and -height
  127. parameters.
  128. Added some asm optimizations from awinquake.
  129. Recompiled with gcc 2.95.1.
  130. Thanks to elf2exe2, the executable is now only 600KB.
  131. Some other minor changes.
  132.  
  133. 0.4:
  134. Changed -memory back to -mem ;)
  135. Removed the cd audio code as it doesn't work currently.
  136.  
  137. 0.3:
  138. Changed -mem to -memory as requested by Chris De Maeyer
  139. Small fix in the mouse handling.
  140. Some other minor changes.
  141.  
  142. 0.2:
  143. Added -bat option.
  144. ChunkyPPC double/triplebuffering actually works now ;)
  145. File access is MUCH faster now.
  146. Game hanged if no .pak files could be found.
  147.  
  148. 0.1:
  149. First release.
  150.  
  151.  
  152. Small FAQ:
  153.  
  154. Q: Why another PPC Quake port?
  155. A: Well it started when I found a bug in the -mem option of Awinquake and
  156.    decided to look at the source. After fixing that, my friend suggested
  157.    that I should learn to play with the mouse instead of the keyboard.
  158.    But the mouse support in Awinquake sucked, so I fixed that too.
  159.    Then I got fed up with the crappy PowerUP software which kept measuring
  160.    my bus speed incorrectly, so I ported it to WarpOS and added chunkyppc
  161.    and joypad support. This is also a good way to sharpen my programming
  162.    skills. Until now I have mainly done/ported some CLI programs.
  163.    I know that Frank Wille and Steffen Haeuser are working on a port too,
  164.    and when finished it will probably be much better than this. In it's
  165.    current state it's too buggy for my taste.
  166.  
  167. Q: Why does the game crash?
  168.    Maybe your stack is too low. Try setting it to 500000 bytes.
  169.    Also try without the -bat parameter.
  170.  
  171. Q: Why doesn't the game work on my GFX card?
  172. A: The GFX card support in WarpQuake might be broken, as it hasn't been
  173.    tested at all. Try the -wpa8 option.
  174.  
  175. Q: Why does mouse slow down the game so much?
  176. A: Because there's much contextswitches needed for this. If you are using
  177.    the keyboard at the same time the slowdown is even worse. This is cured
  178.    by setting the key repeat from input prefs to slowest possible. This
  179.    reduces contextswitches to minimium. If you are running on AGA and don't
  180.    mind the slight flicker, you can also try disabling multibuffering.
  181.  
  182. Q: Why doesn't the middle mouse button work?
  183. A: You probably have some commodity running that uses the button. Disable
  184.    all commodities and try again.
  185.  
  186. Q: Any other speed tips?
  187. A: Use the -bat option to change to BAT MMU setup. This gives about 1 FPS
  188.    more on my 603e/240MHz. Use 320x200 screenmode for best speed.
  189.  
  190. Q: Will there be an PowerUP version?
  191. A: No. I don't trust kernels that can't even measure the bus speed
  192.    correctly.
  193.  
  194. Q: Will there be AHI support?
  195. A: Maybe, but don't bet on it.
  196.  
  197. Q: Is the source available?
  198. A: Yes, as required by the GPL license.
  199.  
  200. Q: Why does the game run in 320x200 although I select a bigger screen?
  201. A: This happens only on GFX cards when using chunkyppc.library.
  202.    Use the -width and -height parameters or -wpa8.
  203.  
  204. Q: Why don't you get a GFX card?
  205. A: Because I'm poor.
  206.  
  207. Q: Well, why don't you get a job then?
  208. A: Because I'm lazy.
  209.  
  210. Q: You're the crapiest coder I've ever seen. Why don't you do something
  211.    useful with your life like collect stamps or something?
  212. A: I know, but I'm learning more everyday.
  213.  
  214. Q: I have some questions that are not answered in this doc. How can I
  215.    reach you?
  216. A: Email to jami.laakkonen@kolumbus.fi
  217.